From 93522ce25f24004571cf54ee60418bfcff9ed8df Mon Sep 17 00:00:00 2001
From: =?utf8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Mon, 18 Apr 2011 01:25:26 +0100
Subject: [PATCH] Move documentation to inline comments: GtkFontSelectionDialog

---
 docs/reference/gtk/tmpl/.gitignore         |   1 +
 docs/reference/gtk/tmpl/gtkfontseldlg.sgml | 129 ---------------------
 gtk/gtkfontsel.c                           |  28 ++++-
 3 files changed, 26 insertions(+), 132 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkfontseldlg.sgml

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index f4f7a77ef9..12b97aeb0b 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -45,6 +45,7 @@ gtkfilechooserwidget.sgml
 gtkfilefilter.sgml
 gtkfontbutton.sgml
 gtkfontsel.sgml
+gtkfontseldlg.sgml
 gtkframe.sgml
 gtkhandlebox.sgml
 gtkhbbox.sgml
diff --git a/docs/reference/gtk/tmpl/gtkfontseldlg.sgml b/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
deleted file mode 100644
index 625ce4961b..0000000000
--- a/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
+++ /dev/null
@@ -1,129 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkFontSelectionDialog
-
-<!-- ##### SECTION Short_Description ##### -->
-A dialog box for selecting fonts
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkFontSelectionDialog widget is a dialog box for selecting a font.
-</para>
-<para>
-To set the font which is initially selected, use
-gtk_font_selection_dialog_set_font_name().
-</para>
-<para>
-To get the selected font use gtk_font_selection_dialog_get_font_name().
-</para>
-<para>
-To change the text which is shown in the preview area, use
-gtk_font_selection_dialog_set_preview_text().
-</para>
-
-<refsect2 id="GtkFontSelectionDialog-BUILDER-UI">
-<title>GtkFontSelectionDialog as GtkBuildable</title>
-<para>
-The GtkFontSelectionDialog implementation of the GtkBuildable interface
-exposes the embedded #GtkFontSelection as internal child with the
-name "font_selection". It also exposes the buttons with the names
-"ok_button", "cancel_button" and "apply_button".
-</para>
-</refsect2>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-<variablelist>
-
-<varlistentry>
-<term>#GtkFontSelection</term>
-<listitem><para>the underlying widget for selecting
-fonts.</para></listitem>
-<term>#GtkDialog</term>
-<listitem><para>the parent class of GtkFontSelectionDialog</para></listitem>
-</varlistentry>
-
-</variablelist>
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkFontSelectionDialog ##### -->
-
-
-
-<!-- ##### FUNCTION gtk_font_selection_dialog_new ##### -->
-<para>
-
-</para>
-
-@title: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_dialog_get_font_name ##### -->
-<para>
-</para>
-
-@fsd: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_dialog_set_font_name ##### -->
-<para>
-
-</para>
-
-@fsd: 
-@fontname: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_dialog_get_preview_text ##### -->
-<para>
-
-</para>
-
-@fsd: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_dialog_set_preview_text ##### -->
-<para>
-
-</para>
-
-@fsd: 
-@text: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_dialog_get_cancel_button ##### -->
-<para>
-
-</para>
-
-@fsd: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_dialog_get_ok_button ##### -->
-<para>
-
-</para>
-
-@fsd: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_dialog_get_font_selection ##### -->
-<para>
-
-</para>
-
-@fsd: 
-@Returns: 
-
-
diff --git a/gtk/gtkfontsel.c b/gtk/gtkfontsel.c
index babe7b236b..a022ed33c0 100644
--- a/gtk/gtkfontsel.c
+++ b/gtk/gtkfontsel.c
@@ -1597,9 +1597,31 @@ gtk_font_selection_set_preview_text  (GtkFontSelection *fontsel,
   gtk_entry_set_text (GTK_ENTRY (priv->preview_entry), text);
 }
 
-/*****************************************************************************
- * GtkFontSelectionDialog
- *****************************************************************************/
+
+/**
+ * SECTION:gtkfontseldlg
+ * @Short_description: A dialog box for selecting fonts
+ * @Title: GtkFontSelectionDialog
+ * @See_also: #GtkFontSelection, #GtkDialog
+ *
+ * The #GtkFontSelectionDialog widget is a dialog box for selecting a font.
+ *
+ * To set the font which is initially selected, use
+ * gtk_font_selection_dialog_set_font_name().
+ *
+ * To get the selected font use gtk_font_selection_dialog_get_font_name().
+ *
+ * To change the text which is shown in the preview area, use
+ * gtk_font_selection_dialog_set_preview_text().
+ *
+ * <refsect2 id="GtkFontSelectionDialog-BUILDER-UI">
+ * <title>GtkFontSelectionDialog as GtkBuildable</title>
+ * The GtkFontSelectionDialog implementation of the GtkBuildable interface
+ * exposes the embedded #GtkFontSelection as internal child with the
+ * name "font_selection". It also exposes the buttons with the names
+ * "ok_button", "cancel_button" and "apply_button".
+ * </refsect2>
+ */
 
 static void gtk_font_selection_dialog_buildable_interface_init     (GtkBuildableIface *iface);
 static GObject * gtk_font_selection_dialog_buildable_get_internal_child (GtkBuildable *buildable,
-- 
2.30.2